Keybindings

This page lists keyboard shortcuts for each Agentty view.

For session states and transition behavior, see Workflow.

Session List🔗

The rotating status-bar FYI: messages on the Sessions list currently surface Enter for opening the selected session and remind you that Agentty refreshes PR statuses every minute.

Project List🔗

The currently active project is highlighted in the table with a * prefix and accented row text, even while cursor selection moves to other rows.

On the Sessions list, c appears only when the selected row is cancelable: review-ready sessions and draft sessions that are still in New before their first staged bundle starts.

Settings🔗

The Settings tab includes:

• Reasoning Level (low, medium, high, xhigh) for Codex and Claude turns in the active project.
• Default Smart Model, Default Fast Model, and Default Review Model for the active project. Default Smart Model can also cycle to Last used model as default.
• Coauthored by Agentty to enable or disable the Co-Authored-By trailer on generated session commit messages for the active project. New projects start with this disabled.
• Open Commands for launching session worktrees in the active project (one command per line).

Tasks🔗

The Tasks tab appears only when the active project contains docs/plan/roadmap.md, and it renders the roadmap's Ready Now, Queued Next, and Parked cards.

Session View🔗

Available actions depend on the session state. The full set in Review state:

During AgentReview, Agentty keeps the same review-oriented shortcuts but hides r until the background focused-review generation finishes and the session returns to Review.

Additional notes:

• Open command behavior: o opens the session worktree in tmux when a local worktree is available. If one Open Commands entry is configured for the active project, it runs immediately. If multiple entries are configured (one command per line), Agentty opens a selector popup.
• Draft sessions: sessions created with Shift+A do not create a worktree until you press s to start the staged bundle, so o stays hidden before the first live turn.
• Branch publish: p is available in Review and AgentReview and opens a publish popup. Press Enter with an empty field to keep the default session branch target, or type a custom remote branch name first.
• Forge review-request publish: Shift+P is available in Review and AgentReview. It opens the publish popup, accepts the same optional custom branch name as p, then creates or refreshes the linked forge review request after the branch push succeeds. GitHub projects publish pull requests, while GitLab projects publish merge requests.
• Focused review persistence: when a focused review has already been generated, it stays visible after opening d diff mode, returning to the session view, or entering Question mode for clarifications.
• Branch publish lock: once a session branch already tracks a remote branch, Agentty locks the popup field and re-publishes to that same remote branch only.
• Branch publish auth: p and Shift+P always run git push first. HTTPS remotes therefore need Git credentials even when the forge CLI is already logged in. Shift+P also needs authenticated gh access for GitHub repositories and authenticated glab access for GitLab repositories. See Forge Authentication for the GitHub and GitLab CLI setup steps.
• Question: opening the session enters Question Input mode until all prompts are answered and submitted, or the clarification turn is ended with Esc.
• Done: c opens a yes/no confirmation, then creates a new draft composer with the continuation text already staged as the first draft message. When Agentty has the merged hash, that staged message is Summarize changes from <full-hash> to use it as an initial context for this session; otherwise it falls back to the saved summary/transcript. t toggles between summary and full output.
• Canceled: c opens a yes/no confirmation, stages the saved summary or transcript as the first draft message, and focuses an empty composer for follow-up notes.
• Review: Runs in read-only review mode. It can use internet lookup and non-editing verification commands, but it should not edit files or mutate git/workspace state.

Publish Popup🔗

Open Command Selector🔗

Diff Mode🔗

The diff panel title shows aggregate line-change totals as +added and -removed counts for the current session diff.

Prompt Input🔗

Prompt input keeps regular text paste on terminal Event::Paste. The dedicated image paste shortcuts insert highlighted [Image #n] tokens directly in the composer and send the referenced local image for Codex, Gemini, and Claude session models. Codex and Gemini preserve the multimodal ordering at transport level, while Claude rewrites the placeholders to local image paths before streaming the prompt.

When the current session was created with Shift+A, pressing Enter stages the current composer contents into the draft bundle and returns to session view. Use s from session view to launch the staged bundle as the first live turn. Sessions created with a start immediately on the first Enter.

Question Input — Option Selection🔗

When predefined options are shown:

Question Input — Free Text🔗

After moving above or below the predefined option list, or when no predefined options exist:

Question Input — Chat Scroll🔗

When chat output is focused (press Tab to switch):

After the last question is answered, Agentty sends one follow-up message to the session with each question and its response, then returns to session view. Pressing Esc at any point ends the turn immediately without sending a reply and returns the session to review.